​
QuickSend

Need to send a critical update or one-off announcement? You can use Siren to send a notification without setting up a workflow. This lets you directly send messages to a user over your desired channel. To send a message, you just need to include the channel, recipient details (matching that channel), and optionally a template name with variables, as shown below. The request must be authorized using your API key. Once sent, Siren will return a notificationId, which you can use to check the message status or fetch replies Here’s a simplified example: 
{
  "channel": "EMAIL",
  "recipient": {
    "email": "user@example.com"
  },
  "template": {
    "name": "welcome_template"
  },
  "templateVariables": {
    "firstName": "John",
    "offerCode": "ABCD123"
  }
}
If you’re not using the default provider configured in the Siren account, you can specify which provider to use by adding the providerIntegration field in the request. Please take a look at API Reference for the details.
Once a message is sent, you can use the following endpoints to track it:
  • GET /message-status/{notificationId} - Check whether the message was delivered, failed, or is still pending.
  • GET /get-reply/{notificationId} - Fetch replies to a message (currently supported for Slack only). This includes main messages and threaded responses from users.
These endpoints help you build a full feedback loop between your system, the provider, and the user. For the complete details, refer to API Reference. You can also send notifications using MCP, AI Agent Toolkit, or SDK, depending on your system architecture.

​
Using MCP (Model Context Protocol)

If you’re using MCP to send a notification quickly, follow these steps:
1

Install or run the MCP server

You can either install it globally using npm install -g @trysiren/mcp, or run it directly with npx -y @trysiren/mcp.
2

Start the server with messaging tool enabled

Run the following command to enable the QuickSend tool:
npx -y @trysiren/mcp --tools=messaging.send --api-key=YOUR_SIREN_API_KEY
3

Configure your development environment

Connect your MCP-compatible environment (e.g., Claude, VS Code, Replit, Cursor) to the running MCP server.
Refer to the MCP documentation for environment-specific setup.
4

Call the `messaging.send` tool

Once configured, use your assistant or client to trigger a notification using the messaging.send method — no workflow setup required.
5

Track message status

Use tools like messaging.getStatus or the /message-status/{id} endpoint to monitor delivery.
Refer to the MCP Server documentation for full implementation details.

​
Using AI Agent Toolkit

f you’re using AI Agent toolkit to send a notification quickly, follow these steps:
1

Install the Agent Toolkit

Install the SDK using your preferred package manager:
npm install @trysiren/agent-toolkit
or
yarn add @trysiren/agent-toolkit
2

Initialize the toolkit with your API key

Import SirenToolkit and pass your API key during initialization.
You can optionally configure the messaging tool permissions.
3

Expose tools to your AI framework

Use the getTools() method to expose Siren tools (like send_message) to frameworks like OpenAI, LangChain, or Vercel AI SDK.
4

Trigger messages using `send_message` tool

The agent can now use function calls to send notifications on supported channel,— just like an API or MCP request.
5

Monitor delivery with `get_message_status` or logs

Use status-checking tools within the agent environment, or fallback to Siren’s tracking endpoints and logs.
Refer to the [AI Agent Toolkit documentation](/docs/AI Agent toolkit) for full implementation details.

​
Using SDK

If you’re using the Siren SDK to send a notification quickly, follow these steps:
1

Install the SDK

pip install trysiren
2

Initialize the client

from siren import SirenClient
client = SirenClient()  # Uses SIREN_API_KEY from environment
3

Send a message

client.message.send(
    recipient_value="user@example.com",
    channel="EMAIL",
    template_name="welcome_template",
    template_variables={
        "firstName": "John",
        "offerCode": "ABCD123"
    }
)
4

(Optional) Track delivery status

client.message.get_status("notificationId")
This example demonstrates usage with the Python SDK. Siren also provides a TypeScript SDK, and the same procedures can be followed using TypeScript as well. For details on the TypeScript SDK and complete SDK usage, refer to the SDK Documentation.
For more complex orchestration, you can utilise the workflow editor and start [designing your own notification workflow](/docs/01 - Getting Started/QuickSend).